home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 23
/
Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso
/
Aminet
/
misc
/
emu
/
amiSPIMsrc.lha
/
readme
< prev
next >
Wrap
Text File
|
1994-01-18
|
7KB
|
251 lines
README file for SPIM & XSPIM
SPIM is copyrighted by James R. Larus and distributed under the
following conditions:
You may make copies of SPIM for your own use and modify those copies.
All copies of SPIM must retain my name and copyright notice.
You may not sell SPIM or distributed SPIM in conjunction with a
commercial product or service without the expressed written consent of
James Larus.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
This directory contains SPIM--an assembly language MIPS R2000/R3000
simulator. The files are:
BLURB
A short description of SPIM.
Configure
A shell script to configure SPIM.
IMakefile
Input to the xmkmf program, which produces a Makefile.
Makefile.std
The descriptor file for make utility program. Use this file if you
do not have xmkmf.
README This file.
VERSION
Version number of system.
buttons.c, buttons.h
X-interface code for command buttons.
data.c, data.h
Code to handle data directives.
inst.c, inst.h
Code to build instructions and manipulate symbol table.
mem.c, mem.h
Code to maintain memory.
mips-syscall.c, mips-syscall.h
Code to handle system calls and exceptions.
op.h
Definition of operations.
parser.y, parser.h
Assembly command parser (YACC).
read-aout.c, read-aout.h
Code to read MIPS a.out executables.
reg.h
Register access macros.
run.c, run.h
Instruction simulator.
scanner.l, scanner.h
Lexical analyzer (LEX).
spim-syscall.h
System call numbers.
spim-utils.c, spim-utils.h
Misc. routines.
spim.c, spim.h
Top-level interface.
sym-tbl.c, sym-tbl.h
Symbol table.
windows.c, windows.h
X-interface code to build windows.
xspim.c, xspim.h
Top-level X-interface.
trap.handler
Standard trap handler.
Tests
Subdirectory contain torture tests to verify that SPIM works.
Documentation/spim.tex
TeX document that describes SPIM.
Documentation/spim.ps
Postscript version of TeX document.
Documentation/SPIM_and_LINUX
Describes changes necessary to SPIM to run under LINUX.
(Since I don't have a system running LINUX, I can't test for these
changes or answer questions about them.)
Documentation/cycle.ps
Describes Anne Roger's cycle-level simulator (cl-spim, cl-xspim).
To make SPIM, run the shell script Configure:
% Configure
and edit the first few lines of Imakefile to set the parameters for
your system. Then type:
% xmkmf
% make
(Note: on RS6000's running AIX, you should edit the Makefile to use the xlc
compiler rather than cc.)
If you want an X-window version of SPIM, also type:
% make xspim
If you do not have X-windows or the program xmkmf, edit the makefile
in Makefile.std and type:
% make -f Makefile.std test
% make -f Makefile.std xspim
To run spim or xspim, the trap handler code must be installed in the
directory specified by the variable TRAP_DIR in the Makefile. If the file
trap.handler is not installed, spim and xspim fail with a message before
they start running. You can either install this file by hand or by typing
% make install
To test that spim is correctly built, type
% make test
and examine the output of the test. (Note: the trap handler must be installed
before running the test.)
What about SPIM on system XYZ????
SPIM should run without many changes on most Unix systems (the great
thing about Unix standards are that there are so many to choose
from...). I, obviously, have not tested SPIM on many system, nor can
I port SPIM to systems that I don't have. However, I would like to
hear about the changes necessary to run SPIM on your favorite system.
In addition, Morgan-Kaufmann Publishers (in conjunction with Patterson
& Hennessy's book "Computer Organization & Design: The Hardware /
Software Interface") distributes a version of SPIM that runs on PC
(under DOS) and Macintoshes. It is based on an older version of SPIM,
so it has a few minor incompatibilities with this version of SPIM.
Since I didn't do the port, I can't answer questions or distribute
these programs; however I will forward bug reports to its maintainers.
This release (5.4) of SPIM and XSPIM has been compiled and tested on the
following systems:
DECStation 3100 running Ultrix 4.2A using cc and gcc
SPARCstation IPX running Sun OS 4.1.3 (with AFS) using cc, gcc, & acc.
This release (5.2) of SPIM and XSPIM has been compiled and tested on the
following systems:
DECStation 3100 running Ultrix 4.2A using cc and gcc
SPARCstation IPX running Sun OS using cc and gcc
RS6000 running AIX 3.2 using xlc
HP 720 (Snake) running HP-UX using cc and gcc
Although SPIM is free software, it cost time and money to produce. If
you use SPIM and work in industry, you can help support development of
software of this sort by having your company make a donation to my
research program. To do this, mail me check (address attached)
payable to ``Computer Sciences Fund -- University of Wisconsin
Foundation.'' The foundation's federal taxpayer identification number
is 39-074-3975.
James Larus
larus@cs.wisc.edu
Computer Sciences Department
1210 West Dayton Street
University of Wisconsin
Madison, WI 53706 USA
608-262-9519
This directory also contains a cycle-level SPIM simulator developed by
Anne Rogers and and Scott Rosenberg of Princeton.
The following copyright applies to all new files in cl-spim and cl-xspim:
SPIM S20 MIPS Cycle Level simulator.
Copyright (C) 1991-1992 by Anne Rogers (amr@cs.princeton.edu) and
Scott Rosenberg (scottr@cs.princeton.edu)
ALL RIGHTS RESERVED.
CL-SPIM is distributed under the following conditions:
You may make copies of CL-SPIM for your own use and modify those copies.
All copies of CL-SPIM must retain our names and copyright notice.
You may not sell CL-SPIM or distributed CL-SPIM in conjunction with a
commercial product or service without the expressed written consent of
Anne Rogers.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
New files for cl-spim and cl-xspim, cycle level simulators:
cl-cycle.[ch]
pipeline simulation
cl-except.[ch]
exception and signal handling
cl-tlb.[ch]
virtual memory simulation
cl-cache.[ch]
instruction and data caching simulation
To make cl-spim or cl-xspim, type:
% make cl-spim
% make cl-xspim
$Header: /var/home/larus/Software/SPIM/RCS/README,v 1.12 1994/01/18 15:25:18 larus Exp larus $